home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 40.zip / BS1 part 40 / ByteByByte.adf / Movie_Readme < prev    next >
Text File  |  2018-01-20  |  5KB  |  124 lines
  1.  
  2.                        -- MOVIE 2.0 --
  3.  
  4. MOVIE is in the Animation drawer.
  5.  
  6. MOVIE 2.0 now supports VIDEO size and Anim5.
  7.  
  8. Movie is a freeware utility which may be used to play back animations
  9. created by Sculpt Animate line of products.  Movie was written by
  10. Dr. Eric Graham, author of SCULPT 3D, Sculpt-Animate 3D, Sculpt-Animate 4D,
  11. and Sculpt-Animate 4D Jr.  Movie's sound capability was added by
  12. Ken Offer of Byte by Byte.
  13.  
  14. The CLI syntax for MOVIE is:
  15.      STACK 10000
  16.      MOVIE animfile [audiofile]
  17. where "animfile" is the name of the RAM animation and "audiofile" is an
  18. optional audio specification file, as explained below.
  19.  
  20. To run MOVIE from the Workbench, you need to have an icon attached to the
  21. animation.  If the animation does not have an icon attached, one may be
  22. attached through the CLI by copying the ".info" file from an existing
  23. animation.  Actually, any PROJECT type icon will do.  The type of the icon
  24. may be checked by selecting the icon and pulling down the Workbench PROJECT
  25. menu to the Info submenu item.  Let's assume you have the 'Kahnankas.anim'
  26. animation by Ken Offer in your external drive and a disk with the animation
  27. 'MyFirstAnim.anim' in your internal drive.  The CLI command would be:
  28.      Copy df1:Kahnankas.anim.info to df0:MyFirstAnim.anim.info 
  29.  
  30. To play the animation, hold down a SHIFT key and click the animation's
  31. icon, then (while still holding down the SHIFT key) double-click the MOVIE
  32. icon.
  33.  
  34. If the animation icon's info structure (accessed through the Workbench's
  35. PROJECT menu INFO submenu command) has MOVIE specified as the DEFAULT TOOL
  36. and MOVIE is on the same directory, then you may run 0the animation just
  37. by double-clicking its icon.  You may also tell your Amiga where you have
  38. the MOVIE program by clicking in the DEFAULT TOOL text gadget and typing
  39. in the path to the MOVIE program followed by a slash and the word MOVIE.
  40. MAKE CERTAIN THAT THE STACK IS SET IN THE INFO SCREEN TO AT LEAST 8000.
  41.  
  42. You may add the animation author's name to the opening screen text by
  43. inserting it into the TOOL TYPES gadget of the animation's INFO screen.
  44. This is done by adding a line such as "AUTHORNAME=Author Name".  Case
  45. is important.  If we don't see the capital letters, you don't see the
  46. author's name.  Omit the quotes.
  47.  
  48. Another item which may be added to the TOOL TYPES is an audio
  49. specification file, an example might be "AUDIOSPECFILE=myanim.audio".
  50. The audio file tells Movie how and when to play back sampled sounds.
  51. To have audio, you must have some number of IFF 8SVX "one-shot" sound
  52. files (NOT instrument files) on the same directory as the animation,
  53. as well as an audio specification in the following format:
  54.  
  55.    +-----------------------------------------------------------
  56.    |IFFSoundFileName0
  57.    |IFFSoundFileName1
  58.    |IFFSoundFileName2
  59.    |
  60.    |    ...and so on, ending the filenames with an '*'.
  61.    |
  62.    |*
  63.    |NForegroundSoundSeq  (i.e.  # of foreground sound frame sequences)
  64.    |Frame#  Sound#  (L for left channel, R for Right) Volume
  65.    |Frame#  Sound#  L or R  Volume
  66.    |...
  67.    |NBackgroundSoundSeq  (i.e.  # of background sound frame sequences)
  68.    |Frame#  Sound#  (L for left channel, R for Right) Volume
  69.    |Frame#  Sound#  L or R  Volume
  70.    |...
  71.    |
  72.  
  73.    An Example is below:
  74.  
  75.    +-------------------------------------------------------
  76.    |gong
  77.    |whistle
  78.    |*
  79.    |2
  80.    |0  0  L  64
  81.    |15 0  R  32
  82.    |1
  83.    |0  1  L  20
  84.  
  85.    The above example will play one sound twice (2) in a cycling animation.
  86.  
  87. At frame 0, it will play sound 0 (gong) in the left speaker at maximum volume,
  88. namely 64.
  89.  
  90. At frame 15, it will play sound 0 in the right speaker at half the
  91. maximum volume, namely 32.
  92.  
  93. There is one background sound in this animation, which is a whistle, and
  94. it starts on frame 0, plays in the left channel, with a volume of 20.
  95.  
  96. Valid frame numbers are 0 to n-1, where n is the number of frames in
  97. your animation (in one complete cycle).  If the number is greater than
  98. n, the sound will not be played.  You may not always know how many
  99. frames an animation has, so it's a little hard to "retrofit" a sound
  100. to an animation, but not too hard.  The best approach is to make a
  101. guess at a frame number and try it, this will quickly tell you how
  102. close you are. 
  103.  
  104. Valid sound numbers are 0 to n-1, where n is the number of sounds in
  105. your animation.
  106.  
  107. Valid channels are L for left and R for right.
  108.  
  109. Valid volumes are 0 through 64.
  110.  
  111. Background sounds are sounds that start up the first time the desired
  112. frame appears, and then cycle on their own until the program ends.
  113.  
  114. If the audio specification file cannot be found, no sound will be played.
  115.  
  116.  
  117.  
  118. KNOWN BUGS:  
  119.  
  120. -- Amiga-N will cause unpleasant effects and a system lockup.  This is
  121.    because MOVIE makes assumtions about the viewport for speed's sake.
  122.  
  123. -- A system file requester has the same effect as Amiga-N.
  124.